home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / utilities / cli / cmp.lha / CMP / cmp.dok next >
Encoding:
Text File  |  1995-01-04  |  8.0 KB  |  274 lines
  1.  
  2.  
  3.                              Objekt-Name:  CMP
  4.  
  5.                     $VER: CMP 2.92 (95.01.04 18:39:04)
  6.  
  7.                      Copyright 1992-95 bei Lutz Hanke
  8.  
  9.  
  10.  
  11.  
  12. Inhalt
  13. ------
  14.   1     Was ist CMP                         38
  15.   2     Rechtslage                          46
  16.   2.1   Autor                               81
  17.   2.2   Programm Umfang                     95
  18.   2.3   System - Vorausetzung              106
  19.   2.4   Einschränkunen                     113
  20.   3     Anleitung                          120
  21.   3.1   Option  <FILE1 FILE2>              127
  22.   3.2   Option  <FILE1 FILE2 OFFSET1 20    148
  23.   3.3   Option  <QUICK>                    159
  24.   3.4   Option  <QQUICK>                   170
  25.   3.5   Option  <CHECKDIR dir>             178
  26.   3.6   Option  <HELP>                     195
  27.   4     Returncodes                        203
  28.   5     Utilities (rexx)                   217
  29.   6     Bugs (Fehler)                      235
  30.   7     Danksagung                         242
  31.   8     History                            249
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38. 1 Was ist CMP
  39. -------------
  40.   CMP dient zum Byte Vergleich von zwei oder mehreren Files. Dabei gibt es
  41.   mehrere Möglichkeiten, die im folgenden beschrieben werden.
  42.  
  43.  
  44.  
  45.  
  46. 2 Rechtslage
  47. ------------
  48.   Das vorliegende Programm-Paket ist Shareware. Alle Rechte liegen bei mir,
  49.   dem Programmierer. Bei regelmäßiger Benutzung ist eine Gebühr von 5.00 DM
  50.   für Deutschland, und 10 DM für das übrige Ausland zu entrichten. Sie
  51.   erhalten dann die neueste Version, ohne eingeschränkte Funktionen. Eine
  52.   kommerzielle Nutzung ist nicht gestattet.
  53.  
  54.   Das Programm darf unter folgenden Bedingungen, auf PD-, Shareware- Serien
  55.   oder Netzwerken vertrieben werden.
  56.  
  57.     - Es müssen die unter "Programm Umfang" genannte Dateien in
  58.       unveränderter Form und Inhalt immer mit kopiert werden.
  59.  
  60.     - Weiterhin ist das Packen gestattet, wenn der Originalzustand wieder
  61.       hergestellt werden kann (z.B. LHA, ZOO, PP).
  62.  
  63.     - Den Vertriebspreis lege ich nicht fest, da es immer neue Medien gibt,
  64.       und damit auch andere Herstellungskosten. Wer mehr als den Shareware
  65.       Beitrag bezahlt ist selbst Schuld.
  66.  
  67.   Das Keyfile darf NICHT frei weiter kopiert werden. Es ist
  68.   Personengebunden, mit dem Namen des Users und der Registriernummer.
  69.  
  70.   Zum Schluß möchte ich noch darauf hinweisen, daß ich für die korrekte
  71.   Funktion keine Garantie übernehme. Es ist daher immer möglich, daß eine
  72.   Fehlfunktion auftritt. Ich lehne daher jegliche Verantwortung für
  73.   derartige oder andere Folgen ausdrücklich ab. Dies gilt auch für
  74.   Folgeschäden, Personenschäden oder andere Nebenwirkungen. Bitte teilen
  75.   Sie mir eventuell auftretende Fehler mit, damit diese umgehend behoben
  76.   werden können.
  77.  
  78.  
  79.  
  80.  
  81. 2.1 Autor
  82. ---------
  83.   Da ich selbst die ganze Angelegenheit "verbrochen" habe, so können Sie
  84.   sich auch direkt bei mir registrieren, updaten oder beschweren. Meine
  85.   Adresse ist folgende:
  86.  
  87.                                 Lutz Hanke
  88.                                 Dorfstr. 43
  89.                               01825 Breitenau
  90.                                   Germany
  91.  
  92.  
  93.  
  94.  
  95. 2.2 Programm Umfang
  96. -------------------
  97.  
  98.   CMP ------ das Programm an sich.
  99.   CMP.dok -- das, was Sie gerade lesen. Eine Anleitung zu CMP.
  100.   rexxc/dopus/cmp_2view.dopus    - siehe weiter unten
  101.   rexx:dopus/cmp_2viewauto.dopus - siehe weiter unten
  102.  
  103.  
  104.  
  105.  
  106. 2.3 System - Vorausetzung
  107. -------------------------
  108.   Der Start ist nur von die Shell möglich.
  109.  
  110.  
  111.  
  112.  
  113. 2.4 Einschränkunen
  114. ------------------
  115.   z.Z. keine Einschränkunen.
  116.  
  117.  
  118.  
  119.  
  120. 3 Anleitung
  121. -----------
  122.   Die Bedienung dürfte wohl kaum jemanden Probleme bereiten, der sich mit
  123.   die Shell auskennt. Ich werden daher alles etwas kurz fassen.
  124.  
  125.  
  126.  
  127. 3.1 Option  <FILE1 FILE2>
  128. -------------------------
  129.   Es sind zwei Argumente anzugeben. Das erste File wird dann im linken, und
  130.   das zweite im rechten Teil aufgelistet. Gefundene Byte Unterschiede,
  131.   werden dann in einer anderen Farbe dargestellt. Zu sehen müßte dann
  132.   folgendes sein :
  133.  
  134.   $000000  000003F3 00000000  ...ó....    000003F3 00000000  ...ó....
  135.   $000008  00000002 00000000  ........    00000002 00000000  ........
  136.   $000010  00000001 000002D1  .......Ñ    00000001 000002D1  .......Ñ
  137.   $000018  0000012A 000003E9  ...*...é    0000012A 000003E9  ...*...é
  138.   $000020  000002D1 48E73F32  ...ÑHç?2    000002D1 48E73F32  ...ÑHç?2
  139.  
  140.   Offset   File 1  hex        Zeichen     File 2  hex        Zeichen
  141.  
  142.   Am Ende wird ausgegeben, ob die beiden Files unterschiedlich lang, und ob
  143.   Unterschiede vorhanden waren.
  144.  
  145.  
  146.  
  147.  
  148. 3.2 Option  <FILE1 FILE2 OFFSET1 20 OFFSET2 22>
  149. -----------------------------------------------
  150.   Die Offsetangabe erfolgt für jedes File seperat, und ist optional. Dabei
  151.   muß das entsprechende Schlüsselwort angegeben werden. Für das File 1 ist
  152.   dies "OFFSET1". Für das File 2 ist dies "OFFSET2". Der Offset zählt ab
  153.   dem File Beginn. Das Zahlenformat kann Dez, Hex und Bin sein. Ansonsten
  154.   gild das oben gesagte.
  155.  
  156.  
  157.  
  158.  
  159. 3.3 Option  <QUICK>
  160. -------------------
  161.   Die schnelle Variante, es werden nur die Unterschiede gemeldet. Ansonsten
  162.   gild das oben gesagte. Die Ausgabe sieht jedoch so aus :
  163.  
  164.   Variation by Byte $000001  03 .  00 .
  165.   Variation by Byte $000005  F3 ó  03 .
  166.  
  167.  
  168.  
  169.  
  170. 3.4 Option  <QQUICK>
  171. --------------------
  172.   Die schnellste Variante, es wird solange getestet, bis ein Byte
  173.   unterschiedlich ist. Dann wird abgebrochen, nur der Returncode gesetzt.
  174.  
  175.  
  176.  
  177.  
  178. 3.5 Option  <CHECKDIR dir>
  179. --------------------------
  180.   CheckDir ist dafür gedacht, mehrere Files zu vergleichen. Da es jedoch so
  181.   ist, daß der Argumenten String nur 255 Zeichen lang sein kann, muß hier
  182.   ein Dir angegeben werden. Dieses Dir wird komplett eingelesen, und von
  183.   jedem File 2kB miteinander verglichen. Zur Ausgabe kommen nur die
  184.   gleichen Bytes aller Files, die Unterschiede werden nur als Punkte
  185.   dargestellt. Das ganze könnte dann folgendes Aussehen haben.
  186.  
  187.   $0000  000003F3 00000000 000000.. 00000000      ó       .    
  188.   $0010  000000.. 0000.... 0000.... 0000....      .  ..  ..  ..
  189.   $0020  ........ 48E73F32 ........ ........   ....Hç?2........
  190.   $0030  ........ ........ ........ ........   ................
  191.  
  192.  
  193.  
  194.  
  195. 3.6 Option  <HELP>
  196. ------------------
  197.   Und nun eine letzte Option. Wird Help angegeben, so erhalten sie
  198.   Informationen über das Programm, Version, Registrierung und Copyright.
  199.  
  200.  
  201.  
  202.  
  203. 4 Returncodes
  204. -------------
  205.   Folgende Returncodes (RC) werden gesetzt :
  206.  
  207.   RC  Ursache
  208.   -------------------
  209.   0   alles ok, kein Unterschied gefunden
  210.   5   CTRL-C abgebrochen, oder Files sind unterschiedlich
  211.   10  File, Seek, Offset error
  212.   99  kein Speicher
  213.  
  214.  
  215.  
  216.  
  217. 5 Utilities (rexx)
  218. ------------------
  219.   CMP wird, bei mir, meist in Verbindung mit DOpus4.11 benutzt. Dabei
  220.   entstehen auch ein paar nützliche Sachen, die ich hier nicht vorenthalten
  221.   will. Eine ausführliche Beschreibung befindet sich auch noch in jedem
  222.   File.
  223.  
  224.   cmp_2view.dopus ----- Vergleicht Files im linken und rechtem Dopus
  225.            Window. Die Optionen "QUICK" und "QQUICK" können optional
  226.            angegeben werden.
  227.  
  228.   cmp_2viewauto.dopus - Vollautomatische Version, selectiert zuerst alle
  229.            gleichen File Namen, und vergleicht diese dann. Am Schluß sind
  230.            diejenigen Files selectiert, die Absolut identisch sind.
  231.  
  232.  
  233.  
  234.  
  235. 6 Bugs (Fehler)
  236. ---------------
  237.   Sind mir keine bekannt.
  238.  
  239.  
  240.  
  241.  
  242. 7 Danksagung
  243. ------------
  244.   Danken kann ich noch keinem. Schade.
  245.  
  246.  
  247.  
  248.  
  249. 8 History
  250. ---------
  251. 09.02.93 Beginn.
  252. 17.02.93 erster Assemblerlauf mit 145 Fehlern, nach 1/2 h nur noch 34
  253.          Fehler Problem Lokale Variablen für Macros
  254. 20.02.93 Option Quick, stellt den ersten Unterschied fest, und meldet diesen
  255. 01.05.93 Umstellung auf 2.0 Benutzung, und Offsetangabe beim ProgStart
  256. 14.03.94 2.1 Programmstructur geändert
  257.              als offset kann jedes zahlenformat benutzt werden
  258.              Option Quick zeigt den unterschied auch Hex an
  259. 11.09.94 2.89 version wurde an die aktuelle angepaßt, beide Routinen wurden
  260.               komplett neu geschrieben, daher jetzt auch File End
  261.               Erkennung, speed etwas verbessert
  262. 23.10.94 2.90 option QQuick schnellstes testen
  263. 02.01.95 2.92 Option CHECKDIR hinzugefügt, das bis dato als selbständiges
  264.               Programm bestand. Daher auch der Argumenten String verändert.
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.   © 1992-95 by Lutz Hanke
  272.  
  273.  
  274.